CurrencySelect Server Control
Warning! In addition to reading this section on the CurrencySelect server controls, Ektron strongly recommends reading Currencies.
The Currency server control allows site visitors to select the monetary type they will use to make purchases. Once the site visitor selects his currency, all eCommerce server controls use it for that order. If a site visitor closes the browser, the currency will need to be selected the next time he visits the site.
For a currency to appear in the CurrencySelect server control, it must be enabled in the Ektron CMS400.NET Workarea > Settings > Commerce > Currencies screen. To enable a currency, click its name in the list and place a check in the enable checkbox. Next, click Save (
).
CurrencySelect Server Control Properties
The following table explains the properties of the CurrencySelect control.
Note: The following table only lists Ektron-specific properties. It does not describe native .NET properties such as font, height, width and border style. For documentation of these properties, see Visual Studio help.
|
Property |
Description |
Data Type |
|
Authenticated |
Indicates if you are logged in to the CMS Explorer and can use it to browse to Content, Collections, etc. See Also: Working with Ektron CMS400.NET Server Controls |
String |
|
CacheInterval |
Sets the amount of time the server control’s data is cached. The default is 0 (zero). This is the amount of time, in seconds, a control’s data is cached. For example, if you want to cache the data for five minutes, set the CacheInterval property to 300 (three hundred). See Also: Caching with Server Controls |
Double |
|
CustomXml (Code Behind Only) |
Provides a mechanism to inject custom XML into the generated XML before being processed by the XSLT. The injected XML is appended to the end of the XML produced by this control. |
String |
|
DisplayXslt |
Specify an external XSLT file to render the control. By default, the control uses CurrencySelect.xsl. This file is located in Important: If you want to edit this file, it is strongly recommended that you make a copy, change its name and move it outside your site’s Workarea folder. If you make changes to this file and do not move it out of the Workarea folder, this file and the changes will be lost when you upgrade. |
String |
|
DoInitFill |
By default, Fill occurs during the Page_Init event. Set to false if you want to postpone the fill-action until later. In this case, FIll is automatically called during the Page Render event. You might do this if you need to set or change a property on the control in codebehind and have it render with your changes shown. |
Boolean |
|
Hide |
Used to hide the control in design time and run time. True = Hide the control False = Show the control |
Boolean |
|
Language |
Set a language for viewing the currency selection tool. This property shows results in design-time (in Visual Studio) and at run-time (in a browser). |
Integer |
|
Stylesheet |
Specify the path to a style sheet for use with this server control. The location can be relative or absolute. Leave blank to use the default style sheet. |
String |
|
SuppressWrapperTags |
Suppresses the output of the span/div tags around the control. The default is False. True - Suppress wrap tags. False - Allow wrap tags. |
Boolean |
